<HTML>
<HEAD>
  <STYLE type="text/css">
    H1 {color: black }
    H2 {color: maroon }
    H3 {color: #007090 }
    A.head:link {color: #0060a0 }
    A.head:visited {color: #3040c0 }
    A.head:active {color: white }
    A.head:hover {color: yellow }
    A.red:link {color: red }
    A.red:visited {color: maroon }
    A.red:active {color: yellow }
  </STYLE>
</HEAD>
<TITLE>Magic-8.3 Command Reference</TITLE>
<BODY BACKGROUND=graphics/blpaper.gif>
<H1> <IMG SRC=graphics/magic_title8_3.png ALT="Magic VLSI Layout Tool Version 8.3">
     <IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>

<H2>get, getcell</H2>
<HR>
Import a cell as a subcell of the current edit cell.
<HR>

<H3>Usage:</H3>
   <BLOCKQUOTE>
      <B>getcell</B> <I>cellname</I> [<I>orientation</I>] <BR><BR>
      <B>getcell</B> <I>cellname</I> [<I>orientation</I>]
		[<B>child</B> <I>child_refpoint</I>]
		[<B>parent</B> <I>parent_refpoint</I>] <BR><BR>
      <BLOCKQUOTE>
         where <I>orientation</I> may be one of the following:
	 <DL>
	   <DT> <B>90</B>
	   <DD> Load rotated by 90 degrees clockwise
	   <DT> <B>180</B>
	   <DD> Load rotated by 180 degrees
	   <DT> <B>270</B>
	   <DD> Load rotated by 90 degrees counterclockwise
	   <DT> <B>v</B>
	   <DD> Load flipped top to bottom
	   <DT> <B>h</B>
	   <DD> Load flipped left to right
	   <DT> <B>90v</B>
	   <DD> Load rotated 90 degrees clockwise and flipped top to bottom
	   <DT> <B>90h</B>
	   <DD> Load rotated 90 degrees clockwise and flipped left to right
	   <DT> <B>180v</B>
	   <DD> Load rotated 180 degrees and flipped top to bottom
	   <DT> <B>180h</B>
	   <DD> Load rotated 180 degrees and flipped left to right
	   <DT> <B>270v</B>
	   <DD> Load rotated 90 degrees counterclockwise and flipped top to bottom
	   <DT> <B>270h</B>
	   <DD> Load rotated 90 degrees counterclockwise and flipped left to right
	 </DL>
	 and <I>child_refpoint</I> and <I>parent_refpoint</I> may be
	 <I>x y</I> coordinate pairs, or one of the four keywords
	 <B>ll</B>, <B>lr</B>, <B>ul</B>, or <B>ur</B>, indicating
	 one of the four box corners, or the keyword <B>label</B>
	 followed by the name of a label in the parent or child cell. <P>

	 For the child, coordinate pairs are
	 in the coordinate system of the child, and corners indicate
	 cell bounding box corners.  For the parent, coordinate pairs
	 are in the coordinate system of the parent, and corners indicate
	 corners of the cursor box.  If <B>child</B> or <B>parent</B>
	 options are not provided, then the default behavior is the same
	 as "<B>child ll</B>" and "<B>parent ll</B>", respectively.
	 If a label name is given, then the position (anchor point) of
	 the label will be used as the reference point.
      </BLOCKQUOTE>
   </BLOCKQUOTE>

<H3>Summary:</H3>
   <BLOCKQUOTE>
      The <B>getcell</B> command creates subcell instances within the
      current edit cell.  By default, with only the <I>cellname</I>
      given, an orientation of zero is assumed, and the cell is placed
      such that the lower-left corner of the cell's bounding box is
      placed at the lower-left corner of the cursor box in the parent
      cell. <P>
   </BLOCKQUOTE>

<H3>Implementation Notes:</H3>
   <BLOCKQUOTE>
      <B>getcell</B> is implemented as a built-in command in <B>magic</B>. <P>
      <B>get</B> is an alias for the command <B>getcell</B> (allowed
      abbreviation where otherwise use would be ambiguous). <P>

      Scripts will find it more convenient to place cells according to
      the cell origin, with the usage "<B>getcell</B> <I>cellname</I>
      <B>child 0 0</B>".
   </BLOCKQUOTE>

<H3>See Also:</H3>
   <BLOCKQUOTE>
      <A HREF=dump.html><B>dump</B></A>
   </BLOCKQUOTE>

<P><IMG SRC=graphics/line1.gif><P>
<TABLE BORDER=0>
  <TR>
    <TD> <A HREF=commands.html>Return to command index</A>
  </TR>
</TABLE>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>
